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ABOUT THIS CHAPTER 


This chapter describes the Shutdown Manager, which gives applications a chance 
to perform any necessary housekeeping before the machine is rebooted or turned 
off. The Shutdown Manager also provides the user with a consistent interface 

for restarting and turning off the different versions of the Macintosh. 
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ABOUT THE SHUTDOWN MANAGER 


With earlier versions of the System file, the Shut Down (a misnomer) menu item 
in the Special menu resulted in the restarting of the machine. There was no way 
to turn the machine off from software; the user needed to choose Shut Down and 
manually toggle the power switch before the machine had begun to reboot. 


On the Macintosh II, two options are available: the Restart menu item results 
in a reboot, while the Shut Down menu item actually turns off power to the 
machine. 


The Macintosh SE does not have power-off capability from software. When the 
user chooses Restart, the machine is rebooted. When the user chooses Shut Down, 
the Shutdown Manager blackens the screen and calls the System Error Handler with 
an error code of 42. This causes an alert to be presented, telling the user 
it's safe to turn off the machine. 


The Shutdown Manager is contained in the System Resource File (System file 
version 3.3 or later) and is compatible with all earlier versions of the 
Macintosh. If the Shutdown Manager is present and the user chooses Restart, the 
machine is rebooted. On all earlier machines (with the exception of the 
Macintosh XL), if the user chooses Shut Down, the Shutdown alert is presented. 
On the Macintosh XL, Shut Down fades the screen and turns off the power. 
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USING THE SHUTDOWN MANAGER 


The ShutDwnPower procedure turns the machine off; if the Macintosh must be 
turned off manually, the Shutdown alert is presented to the user. The 
ShutDwnStart procedure causes the machine to reboot. 


Warning: ShutDwnPower and ShutDwnStart are used by the Finder and other 
system software; your application should have no need to call these 
two routines. 


Both ShutDwnPower and ShutDwnStart check to see if Switcher is running; if it 
is, the ExitToShell procedure is called, exiting Switcher and returning control 
to the Finder. Otherwise, they perform standard system housekeeping prior to 
reboot or power off; this housekeeping can be divided into two phases. In the 
first phase, the unit table is searched for open drivers (including desk 
accessories). For each driver, if the dNeedGoodbye bit in the drvrFlags field 
is set (see the Device Manager chapter for details), a Control call with csCode 
equal to —1 is sent to the driver's control routine. Then, the UnloadScrap 
function is called, writing the desk scrap to the disk. 


Note: While the Finder does not currently read the scrap at boot time, it 
may do so in the future. 


In the second phase of housekeeping, the volume-control-block queue is searched; 
for each mounted volume, the UnmountVol and Eject routines are called. 


The ShutDwnInstall procedure lets you install your own shutdown procedure(s) 
prior to either of these two system housekeeping phases, as well as just prior 
to rebooting and/or power off. The ShutDwnRemove procedure lets you remove your 
shutdown procedures. 
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SHUTDOWN MANAGER ROUTINES 


Assembly-language note: You can invoke each of the Shutdown Manager routines 
with a macro that has the same name as the routine 
preceded by an underscore. These macros expand to 
invoke the Shutdown trap macro. The Shutdown trap 
determines which routine to execute from a routine 
selector, an integer that's passed to it in a word on 
the stack. The routine selectors are as follows: 


sdPowerOf f . EQU 1 
sdRestart . EQU 2 
sdinstall . EQU 3 
sdRemove . EQU 4 


PROCEDURE ShutDwnPower; 


ShutDwnPower performs system housekeeping, executes any shutdown procedures you 
may have installed with ShutDwnInstall, and turns the machine off. (If the 
machine must be turned off manually, the shutdown alert is presented. ) 


PROCEDURE ShutDwnStart; 


ShutDwnPower performs system housekeeping, executes any shutdown procedures you 
may have installed with ShutDwnInstall, and reboots the machine. 


Assembly-language note: ShutDwnStart results in the execution of the Reset 
instruction, followed by a jump to the ROM boot code 
(the address is the value of the global variable 
ROMBase + 10). 


PROCEDURE ShutDwnInstall (shutDwnProc: ProcPtr; flags: INTEGER); 


ShutDwnInstall installs the shutdown procedure pointed to by shutDwnProc. The 
flags parameter indicates where in the shutdown process to execute your shutdown 
procedure. The following masks are provided for setting the bits of the flags 
parameter: 


CONST sdOnPowerOff =i {call procedure before power off} 
sdOnRestart S20 {call procedure before restart} 
sdOnUnmount = 4; {call procedure before unmounting} 
sdOnDrivers = {call procedure before closing drivers} 


8; 
sdRestartOrPower = sdOnPowerOff + sdOnRestart {call procedure before } 
{ either power off or restart} 


PROCEDURE ShutDwnRemove (shutDwnProc: ProcPtr); 
ShutDwnRemove removes the shutdown procedure pointed to by shutDwnProc. 


Note: If the procedure was marked for execution at a number of points in the 
shutdown process (say, for instance, at unmounting, restart, and power 
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off), it will be removed at all points. 
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SUMMARY OF THE SHUTDOWN MANAGER 


Constants 
CONST 


{ Masks for ShutDwnInstall procedure } 


sdOnPowerOf f = 1; {call procedure before power off} 
sdOnRestart =D {call procedure before restart} 
sdOnUnmount = 4; {call procedure before unmounting} 
sdOnDrivers = 8; {call procedure before closing drivers} 
sdRestartOrPower = sdOnPowerOff + sdOnRestart; {call procedure before } 
{ either power off or restart} 
Routines 


PROCEDURE ShutDwnPower; 

PROCEDURE ShutDwnStart; 

PROCEDURE ShutDwnInstall (shutDwnProc: ProcPtr; flags: INTEGER); 
PROCEDURE ShutDwnRemove (shutDwnProc: ProcPtr); 


Assembly-Language Information 
Constants 


; Masks for ShutDwnInstall procedure 


sdOnPowerOf f .EQU 1 ;call procedure before power off 

sdOnRestart .EQU 2 ;call procedure before restart 

sdOnUnmount .EQU 4 ;call procedure before unmounting 

sdOnDrivers .EQU 8 ;call procedure before closing drivers 
sdRestartOrPower .EQU sdOnPowerOff + sdOnRestart ;call procedure before 


; either power off or restart 


Routine selectors 

(Note: You can invoke each of the Shutdown Manager routines with 
a macro that has the same name as the routine preceded by an 
underscore. ) 


. 
td 
. 
| 
. 
, 
. 
| 


sdPower0f f . EQU 1 
sdRestart . EQU 2 
sdinstall . EQU 3 
sdRemove . EQU 4 


Trap Macro Name 
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_ Shutdown 


(Note: You can invoke each of the Shutdown Manager routines with a macro that 
has the same name as the routine preceded by an underscore. Also, be 
aware that the Shutdown macro is not in ROM.) 


END OF DOCUMENT 
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